<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="de">
<head>
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
 <meta name="Page-topic" content="LDreq()" />
 <meta name="Description" content="ST-Open Libraries: LDreq()" />
 <meta name="Keywords" content="ST-Open Software, Open Source, ST-Open, Software, Bibliothek, Bibliotheken, freie Software, Assembler, C" />
 <meta name="date" content="2009-05-08T00:00:00+00:00" />
 <meta name="robots" content="index,follow" />
 <meta name="revisit-after" content="14 days" />
 <meta name="generator" content="Bernhard Schornak, handwritten" />
 <style type="text/css"><!--@import "../../st.css";--></style>
 <link rel="SHORTCUT ICON" href="../../../../pics/favicon.ico" />
 <title>LDreq()</title>
</head>
<body id="top">
<div class="pagehd">
<div id="menu">
<ul>
 <li><a href="../../../indexe.htm">Software</a></li>
 <li><a href="../tut/index.htm">Tutorials</a></li>
 <li><a href="../index.htm">Documentation</a></li>
 <li><a href="../alp.htm">alphabetical</a></li>
 <li><a href="../fct.htm">by Function</a></li>
</ul>
</div>
<div class="update">[2009-05-08]</div><div class="headpc"><img src="../../pics/ste.png" alt="SourceDoc Logo" width="75" height="75" border="0" /></div>
</div>
<div class="crlf1"></div>
&#160;&#160;&#160;<a href="../index.htm"><img src="../../../../pics/nav_up.png" alt="up" width="20" height="20" border="0" title="up" /></a>
&#160;&#160;&#160;<a href="ldr00.htm"><img src="../../../../pics/nav_bk.png" alt="previous" width="20" height="20" border="0" title="previous" /></a>
&#160;&#160;&#160;<a href="ldr02.htm"><img src="../../../../pics/nav_fw.png" alt="next" width="20" height="20" border="0" title="next" /></a>
<div class="text100"><div class="inner">..\st7\lib\sources\core\ldr.S</div><div class="outer"><big>sys.lib</big></div></div>
<div class="crlf1"></div>
<div class="text100"><div class="inner"><b>LDreq</b></div><div class="outer">Function</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">rc = LDreq(address);</div><div class="outer">Call</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">
<div class="inners">VOID *</div>
<div class="inners">address</div>
<div class="innerl">address of a <a href="../tut/0102.htm">LD structure</a></div>
</div><div class="outer">Input</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">
<div class="inners">DD</div>
<div class="inners">rc</div>
<div class="innerl">00000000 - ERR_NO_ERROR<div class="crlf0"></div>00000004 - ERR_LDR_BUSY<div class="crlf0"></div>
00000017 - ERR_LDR_CORRUPT<div class="crlf0"></div>0000001A - ERR_LDR_OUT_OF_MH<div class="crlf0"></div>
0000001B - ERR_LDR_ALLOC<div class="crlf0"></div>0000001C - ERR_LDR_FORBIDDEN<div class="crlf0"></div>
00000020 - ERR_FILE_OPEN<div class="crlf0"></div>00000022 - ERR_FILE_READ</div>
</div><div class="outer">Output</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">
LDreq() allocates a memory block with the properties specified in the passed <a href="../tut/0102.htm">LD structure</a>.
 Depending on the parameters passed in the <a href="../tut/0102.htm">LD structure</a>, a data field or a file can be loaded
 without one additional line of code. You even may load specific parts of a file into a specific part of the allocated memory
 block if you set the corresponding parameters to appropriate values.
</div><div class="outer">Description</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">
To learn more about ST-Open's Loader, I suggest to read the <a href="../tut/0400.htm">Loader Tutorial</a>. It offers detailed
 information about the possibilities and capabilities the Loader provides and supports.
</div><div class="outer">Note 1</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">
You should store the MemHandle (memory handle) returned in structure member <i>MMoff</i> in a global variable if you want to
 access the allocated memory block, field or file in other functions. MemHandles are required for DBE calls and all Loader
 functions, including LDfre() to free the memory block later on.
</div><div class="outer">Note 2</div></div>
<div class="crlf2"></div>
&#160;&#160;&#160;<a href="../index.htm"><img src="../../../../pics/nav_up.png" alt="up" width="20" height="20" border="0" title="up" /></a>
&#160;&#160;&#160;<a href="ldr00.htm"><img src="../../../../pics/nav_bk.png" alt="previous" width="20" height="20" border="0" title="previous" /></a>
&#160;&#160;&#160;<a href="ldr02.htm"><img src="../../../../pics/nav_fw.png" alt="next" width="20" height="20" border="0" title="next" /></a>
<div class="crlf1"></div>
&#160;&#160;&#160;<a href="http://validator.w3.org/check?uri=http%3A%2F%2Fst-open.com%2Fst-open%2Fdoc%2Fe%2Fsys%2Fldr01.htm">
<img src="../../../../pics/xhtml.png" alt="validHTML" width="100" height="35" border="0" title="validate XHTML" /></a>
<div class="crlf1"></div>
</body>
</html>
